home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / race160c.zip / RACEREAD.ME < prev   
Text File  |  1992-03-29  |  10KB  |  226 lines
  1.  
  2.  
  3.    ┌────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┐
  4.    │                                                                      │
  5.    │    THIS IS A BETA VERSION!  This BETA version of RACE has been       │
  6.    │    released to the general public under the following conditions:    │
  7.    W                                                                      W
  8.    A      1: You accept FULL responsibility for any and all damage        A
  9.    R         this software may cause to your system because of bugs       R
  10.    N         or any other unforseen problems.                             N
  11.    I                                                                      I
  12.    N      2: You should not expect bug fixes or updates with any          N
  13.    G         regularity nor should you expect elaborate docs or           G
  14.    │         packaging.                                                   │
  15.    │                                                                      │
  16.    │                                                                      │
  17.    │                                                                      │
  18.    └────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┘
  19.  
  20.  
  21. DO NOT use this software if any of the above bothers you. At this point in
  22. time, RACE v1.60 is largely untested.  It seems to work ok for me, and I
  23. made every effort to insure the quality, but stuff happens.
  24.  
  25. RACE v1.60c - 03/22/92
  26.  
  27. WHOOPS!
  28. ------
  29. The Whoops! function has been changed to support eRACEm 0.6's writing
  30. of the users extra info (subdate, birthdate, etc.) to a USERSXI.OLD file.
  31. If you use the Whoops! function in RACE v1.60c, full support will only be
  32. achieved by using eRACEm 0.6 or above.  By saving ALL the user info,
  33. restoring a user with Whoops! will be a bit more useful.
  34.  
  35. Validation BUG FIX
  36. ------------------
  37. User subscription dates were not properly updated (again) when using a
  38. template to upgrade a user.  Fixed.
  39.  
  40. VALIDATION
  41. ----------
  42. Validation routines are in the process of being changed. If you use
  43. validation regularly as many RACE users do, I suggest you keep the current
  44. release copy of RACE until you are sure this version is working to your
  45. satisfaction.  This =IS= a beta copy!
  46.  
  47. There have been some major changes to Validation.  RACE now creates and
  48. constantly updates an index file for the answer file.  This file will have
  49. the same filename as the answer file and an extension of .IDX and it will
  50. be created in the RA system directory.  There will be one .IDX file for
  51. each answer file you view with validation.  Each record in the .IDX file
  52. (one for each set of answers) consumes 9 bytes of disk space.
  53.  
  54. Creation and updating of the index is done automatically.  RACE parses the
  55. answer file and updates the index each time you go into validation or when
  56. you <P>ick a new answer file from within validation.
  57.  
  58. RACE also does a simple test of the index before parsing.  RACE reads the
  59. last index record and attempts to go to that position in the answer file.
  60. If that position does not exist (such as when you deleted the answer file
  61. but not the index) then RACE will rebuild the index from the start.
  62.  
  63. The above test will not account for all possible problems.  If, for
  64. example, you manually edit answers out of the file then allow RA to add new
  65. answers before ever running RACE, the test may past but the last old
  66. entries in the index may not actually point to the start of a set of
  67. answers.  If in doubt, delete the .IDX file and allow RACE to rebuild it.
  68. It only takes a few seconds on average sized answer files.
  69.  
  70. This index file contains a 'last read' pointer so that RACE knows where
  71. you left off on validating during your last use of CTRL-V type validation.
  72.  
  73. This is the first record in the index.  The remaining records contain a 32
  74. bit CRC of the user name (for searching), a long integer that contains the
  75. exact byte offset of the user's answers in the answer file and an attribute
  76. byte that allow flagging a set of answers deleted when you delete the user.
  77. RACE currently sets this deleted flag but at this point in time there is no
  78. packing util to get rid of the deleted answers nor does RACE handle those
  79. records in any special way.  I do plan to create a packing util for the
  80. answer file.
  81.  
  82. You may now allow your answer file to constantly grow and not have to
  83. put up with RACE starting at the beginning each time you go into
  84. validation.  Keep in mind that the 'last read' is wherever you were when
  85. you quit last time not the highest record number you viewed.  If you jump
  86. to the first record then quit, RACE will start at the first record on your
  87. next entry to validation.
  88.  
  89. You now move forward AND backward through the answer file using the right
  90. and left arrow keys.  You may also use HOME and END to jump to the first
  91. and last set of answers respectively.  RACE no longer uses <N>ext.
  92.  
  93. FIND
  94. ----
  95. F)ind will still allow you to find other answers the currently viewed
  96. user may have but you will now be prompted "Search Forward?". <Y> or
  97. <ENTER> to this prompt will search forward otherwise hit <N> to search
  98. backwards.  Once the search has begun AND answers are found, you may move
  99. back and forth to the various answer sets of that user by using the arrow
  100. keys.  Once you are at the last set of answers for that user (in either
  101. direction), RACE reports no more answers found and the find command is
  102. toggled off.
  103.  
  104. SEARCH
  105. ------
  106. S)earch will allow you to search for a specific user's answers.  Since
  107. RACE searches the index file for a CRC match and not the answer file, it
  108. will only find EXACT matches.  Your input is converted to uppercase and
  109. then a CRC is calculated on the name.  RACE then searches the index for a
  110. match. Because of this method, partial names will never score a match since
  111. the CRC will never be exactly the same.
  112.  
  113. VIP & TRASH
  114. -----------
  115. V)ip and T)rash have been added.  These will insert the currently
  116. viewed user name into the VIP.CTL or TRASHCAN.CTL file as the command
  117. letter indicates.  Removing the user names from those files is still
  118. done by the old manual method.
  119.  
  120.  
  121. ANSWER FILE
  122. -----------
  123. If you do not care to keep your answer file around, remove the index file
  124. when you remove the answer file.  In other words, if you remove the
  125. NEWUSER.ASW, also remove the NEWUSER.IDX file.  As mentioned above, RACE
  126. attempts to handle invalid indexes but it is possible to confuse it.
  127.  
  128. The "Storage file" is no longer supported in RACE. Because of the indexing
  129. method and RACE's ability to start where you left off, it was felt that
  130. this was redundant.  The actual answer file may now be used as storage.
  131. This makes it easy to review a particular user's answers at any time while
  132. in RACE.
  133.  
  134.  
  135. INDEX STRUCTURE
  136. ---------------
  137. For those that may have some use for the answer file index that RACE
  138. creates, or if you are just curious, here's the structure.
  139.  
  140.  AnswerIdx = Record
  141.                Position  : Longint;   {byte position of start of answer text}
  142.                NameCRC   : Longint;   {32 bit CRC of uppercase name}
  143.                Attribute : Byte;      {bit 0 set = deleted}
  144.              End;
  145.  
  146. Record 0 in the index file contains (in AnswerIdx.Position) the index
  147. record number of the last answers viewed when you quit validation.
  148.  
  149. A name CRC was used in place of the actual string for space savings.  While
  150. the full name would have made searching for partial matches possible, I
  151. felt that the extra space required for the index on large answer files
  152. would have been detrimental.
  153.  
  154. RACE uses the answer start position to find the desired answers AND then
  155. looks at the next index record to get the start of the next set for the
  156. purpose of determining where the desired answers END.  So you can see that
  157. manually editing the answer file could confuse matters if you don't force
  158. RACE to re-index.
  159.  
  160.  
  161. RACE v1.60b - 02/14/92
  162.  
  163. Corrected a bug in the REPORTS portion of the code.  Going into reports
  164. and then answering 'N' to "Continue with report" would generate an error.
  165.  
  166.  
  167.  
  168.  
  169. RACE v1.60a - 01/24/92
  170.  
  171. Totally rewrote the message posting routines and improved the handling of
  172. the imported text.  RACE also now supports most, but not all, of the ^F
  173. text control codes that RemoteAccess provides.  The ^F codes are the
  174. individual user information codes. The codes may be used in any text that
  175. RACE places in the RA message base.  This includes manually typed messages
  176. using RACEEDIT or welcome messages in validation.
  177.  
  178. All valid text control codes are listed at the end of this document.
  179.  
  180. Fixed <A>dding of months in validation.  previously, if one selected <A>dd
  181. (as opposed to <R>estart) the date would have the correct number of months
  182. added but the day of the month was usually wrong.
  183.  
  184.  
  185. Added option for user name format in lists.  You may choose whether or not
  186. you want names to appear as "Lastname, Firstname" or "Firstname Lastname".
  187. This is active in REPORTS, and the 'usered' style user list screen.  Go
  188. into RACECFG => Miscellaneous to toggle this option to your desired setting.
  189.  
  190.  
  191. Packing and sorting have been removed from RACE.  This is now handled by the
  192. external 'eRACEm' utility provided with RACE.  See the eRACEm docs that
  193. accompany that file.  <W>hoops! for restoring users packed out by eRACEm
  194. is still available.  This option has replaced <K>eys in the main menu.
  195.  
  196.  
  197. The following control codes are active:
  198.  
  199. ^FA = user's full name
  200. ^FB = user's location
  201. ^F3 = user's handle
  202. ^F4 = Date of first call
  203. ^F5 = date of birth
  204. ^F6 = Subscription date
  205. ^FC = Password
  206. ^FD = Data phone number
  207. ^FE = Home phone number
  208. ^FF = Date of last call
  209. ^FG = Time of last call
  210. ^FL = NetMail credit
  211. ^FM = Total messages posted
  212. ^FO = Security level
  213. ^FP = Total calls to the BBS
  214. ^FQ = Number of uploads
  215. ^FR = Kilobytes of uploads
  216. ^FS = Number of downloads
  217. ^FT = Kilobytes of downloads
  218. ^FU = Minutes used today
  219. ^FW = user's first name
  220. ^F? = User's file ratio in number of files.
  221. ^F@ = User's file ratio in Kilobytes
  222.  
  223. If you are not familiar with how these codes work, see the RemoteAccess
  224. documentation.  RACE handles the codes in exactly the same manner.
  225.  
  226.